home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / aview.z / aview
Text File  |  1998-10-30  |  24KB  |  397 lines

  1.  
  2.  
  3.  
  4. aaaavvvviiiieeeewwww((((1111))))                                                              aaaavvvviiiieeeewwww((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aview, ArrayView - array status monitor for the X Window System
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      AAAArrrrrrrraaaayyyyVVVViiiieeeewwww [_o_p_t_i_o_n_s...]
  13.      aaaavvvviiiieeeewwww [_o_p_t_i_o_n_s...]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      The _A_r_r_a_y_V_i_e_w command (also known by its synonym _a_v_i_e_w) is used to
  17.      display status information about the various machines in an array.
  18.  
  19.      The _A_r_r_a_y_V_i_e_w window is made up of two sections.  In the top section, a
  20.      brief summary of the overall system utilization of each machine is
  21.      displayed.  In the bottom section, a separate pane for each machine is
  22.      used to display more detail about some aspect of the system, such as
  23.      logged-in users or the most active processes.  The relative size of the
  24.      upper and lower sections can be controlled by dragging the "sash" button
  25.      on the right hand side of the separator line between them.
  26.  
  27.      The type of information displayed in the lower section of the _A_r_r_a_y_V_i_e_w
  28.      window is controlled from the VVVViiiieeeewwww menu.  There are several options:
  29.  
  30.      CCCCPPPPUUUU HHHHooooggggssss
  31.             Displays information about the most active processes on each
  32.             machine, according to their CPU utilization sampled over a period
  33.             of several seconds.
  34.  
  35.      PPPPrrrroooocccceeeesssssssseeeessss
  36.             Displays information about all active processes on each machine.
  37.  
  38.      UUUUsssseeeerrrrssss  Displays a list of all users logged in to each machine.
  39.  
  40.      In the CCCCPPPPUUUU HHHHooooggggssss and PPPPrrrroooocccceeeesssssssseeeessss views, it is possible to select an
  41.      individual array session by clicking on a process belonging to that array
  42.      session with the left mouse button.  Once an array session has been
  43.      selected, various actions can be performed on it from the AAAAccccttttiiiioooonnnnssss menu.
  44.      These include:
  45.  
  46.      KKKKiiiillllllll SSSSeeeessssssssiiiioooonnnn
  47.             Kill the array session by sending a TERM signal to all of the
  48.             processes in the array session.
  49.  
  50.      SSSSuuuussssppppeeeennnndddd SSSSeeeessssssssiiiioooonnnn
  51.             Temporarily suspend the array session by sending a TSTP signal to
  52.             all of the processes in the array session.
  53.  
  54.      RRRReeeessssuuuummmmeeee SSSSeeeessssssssiiiioooonnnn
  55.             Resume a suspended array session by sending a CONT signal to all
  56.             of the processes in the array session.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaavvvviiiieeeewwww((((1111))))                                                              aaaavvvviiiieeeewwww((((1111))))
  71.  
  72.  
  73.  
  74.      In addition, a popup menu containing these actions will be displayed when
  75.      the right mouse button is clicked on a process.
  76.  
  77.      The LLLLaaaauuuunnnncccchhhh menu can be used to launch programs that use the MPI or PVM
  78.      message passing libraries.  The MMMMPPPPIIII JJJJoooobbbb............ item will invoke the _m_p_i_v_i_e_w
  79.      program if it has been installed.  If the MMMMPPPPIIIIRRRRUUUUNNNN____DDDDIIIIRRRR environment variable
  80.      was set when _A_r_r_a_y_V_i_e_w was invoked, its value will be passed along to
  81.      _m_p_i_v_i_e_w as well (note, however, that no other environment variables are
  82.      passed along).  Similarly, the PPPPVVVVMMMM JJJJoooobbbb............ item will invoke the _x_p_v_m
  83.      program if it has been installed.  If the PPPPVVVVMMMM____RRRROOOOOOOOTTTT environment variable
  84.      was set when _A_r_r_a_y_V_i_e_w was invoked, its value will be passed along to
  85.      _x_p_v_m.  If _m_p_i_v_i_e_w or _x_p_v_m are not installed, selecting the corresponding
  86.      menu item will cause an error dialog box to be displayed.
  87.  
  88. OOOOPPPPTTTTIIIIOOOONNNN SSSSEEEETTTTTTTTIIIINNNNGGGGSSSS
  89.      The OOOOppppttttiiiioooonnnnssss menu is used to control some of the details of operating
  90.      _A_r_r_a_y_V_i_e_w.
  91.  
  92.    AAAArrrrrrrraaaayyyy SSSSeeeelllleeeeccccttttiiiioooonnnn
  93.      The AAAArrrrrrrraaaayyyy............ item of the OOOOppppttttiiiioooonnnnssss menu brings up the AAAArrrrrrrraaaayyyy SSSSeeeelllleeeeccccttttiiiioooonnnn
  94.      dialog box, which consists mostly of a list of the arrays known to the
  95.      currently selected array services daemon.  The array currently being
  96.      displayed will be highlighted.  To switch to a different array, simply
  97.      select it from the list and click OOOOKKKK.  Selecting <<<<ddddeeeeffffaaaauuuulllltttt>>>> will cause the
  98.      array services daemon's default array to be chosen.
  99.  
  100.    RRRReeeeffffrrrreeeesssshhhh SSSSeeeettttttttiiiinnnnggggssss
  101.      The RRRReeeeffffrrrreeeesssshhhh............ item of the OOOOppppttttiiiioooonnnnssss menu brings up the RRRReeeeffffrrrreeeesssshhhh SSSSeeeettttttttiiiinnnnggggssss
  102.      dialog box.  This is used to control how the screen and data are
  103.      refreshed.  When the AAAAuuuuttttoooo rrrreeeeffffrrrreeeesssshhhh option is turned on, the screen will be
  104.      refreshed periodically with the latest available information.  The
  105.      interval (in seconds) between automatic refreshes is controlled by the
  106.      SSSSccccrrrreeeeeeeennnn rrrreeeeffffrrrreeeesssshhhh field of the dialog box.  When AAAAuuuuttttoooo rrrreeeeffffrrrreeeesssshhhh is off, data
  107.      can be refreshed manually by selecting the RRRReeeeffffrrrreeeesssshhhh nnnnoooowwww item on the VVVViiiieeeewwww
  108.      menu.
  109.  
  110.      If the FFFFrrrreeeeeeeezzzzeeee oooonnnn sssseeeelllleeeecccctttt option of the RRRReeeeffffrrrreeeesssshhhh SSSSeeeettttttttiiiinnnnggggssss dialog is chosen,
  111.      then automatic refresh will be suspended temporarily whenever an array
  112.      session has been selected.  Auto-refresh will resume ("thaw") when an
  113.      action is performed on the array session or when the array session is
  114.      deselected by clicking on it a second time.  If FFFFrrrreeeeeeeezzzzeeee oooonnnn sssseeeelllleeeecccctttt is _n_o_t
  115.      chosen, it is possible that a selection may be lost if the screen is
  116.      refreshed before an action is performed.
  117.  
  118.      The RRRReeeeffffrrrreeeesssshhhh oooonnnn tttthhhhaaaawwww option causes the screen to be refreshed immediately
  119.      after resuming auto-refresh.  This can be useful if the screen refresh
  120.      interval is large.
  121.  
  122.      The CCCCoooolllllllleeeeccccttttiiiioooonnnn ssssaaaammmmpppplllleeee lllleeeennnnggggtttthhhh interval is used to specify the length in
  123.      seconds of the sample interval used by the CCCCPPPPUUUU HHHHooooggggssss view.  It has no
  124.      effect on the other views.  The PPPPaaaauuuusssseeee bbbbeeeettttwwwweeeeeeeennnn ssssaaaammmmpppplllleeeessss interval controls
  125.      the length (in seconds) of the pause between the time that one batch of
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaavvvviiiieeeewwww((((1111))))                                                              aaaavvvviiiieeeewwww((((1111))))
  137.  
  138.  
  139.  
  140.      data is received from the array services daemon and the time that the
  141.      next one is requested.  Notice that this is separate from the screen
  142.      refresh interval, because screen refresh is asynchronous with data
  143.      collection.  If the screen refresh interval is large, it may be useful to
  144.      increase the pause interval as well to avoid unnecessary overhead.
  145.  
  146.    SSSSeeeerrrrvvvveeeerrrr IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  147.      The SSSSeeeerrrrvvvveeeerrrr............ item of the OOOOppppttttiiiioooonnnnssss menu brings up the SSSSeeeerrrrvvvveeeerrrr IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  148.      dialog box.  Ordinarily, it is only necessary to change this information
  149.      if you wish to use an alternate array services daemon.  The HHHHoooossssttttnnnnaaaammmmeeee and
  150.      PPPPoooorrrrtttt nnnnuuuummmmbbbbeeeerrrr fields of this dialog box are used to select the location of
  151.      the array services daemon to be contacted for status information.  The
  152.      FFFFoooorrrrwwwwaaaarrrrdddd rrrreeeeqqqquuuueeeessssttttssss vvvviiiiaaaa llllooooccccaaaallll sssseeeerrrrvvvveeeerrrr option is used to route all array
  153.      services requests via the local array services daemon, even if they are
  154.      destined for a different machine.  It is generally only necessary to do
  155.      this when array services authentication is being used and you do not wish
  156.      to manually set the authentication keys.  If you wish for array services
  157.      requests to be sent directly to the target servers even though
  158.      authentication is in use, it is necessary to specify the local and remote
  159.      authentication keys in the appropriate fields of the AAAAuuuutttthhhheeeennnnttttiiiiccccaaaattttiiiioooonnnn
  160.      section of the dialog box.  Contact your system administrator for these
  161.      keys, or see _a_r_r_a_y_d(1m) and _a_r_r_a_y_d._c_o_n_f(4) for more information.
  162.  
  163. CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
  164.      Valid options include:
  165.  
  166.      _----_aaaa_rrrr_rrrr_aaaa_yyyy _a_r_r_a_y_n_a_m_e
  167.           Specifies the name of the array to be monitored.  If not specified,
  168.           the array services daemon's default destination will be used.
  169.  
  170.      _----_dddd_iiii_rrrr_eeee_cccc_tttt
  171.           Indicates that array services requests destined for remote servers
  172.           should be sent directly to those servers, rather than being
  173.           forwarded to them by the local array services daemon.  This will
  174.           fail on systems that use array services authentication unless the
  175.           ----KKKKllll and ----KKKKrrrr options are also specified.  _----_dddd_iiii_rrrr_eeee_cccc_tttt is the default
  176.           behavior under normal circumstances (but see the description of the
  177.           _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD variable, below).  Specifying _----_dddd_iiii_rrrr_eeee_cccc_tttt is equivalent
  178.           to turning off the FFFFoooorrrrwwwwaaaarrrrdddd rrrreeeeqqqquuuueeeessssttttssss vvvviiiiaaaa llllooooccccaaaallll sssseeeerrrrvvvveeeerrrr option in the
  179.           SSSSeeeerrrrvvvveeeerrrr IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn dialog.
  180.  
  181.      _----_dddd_eeee_mmmm_oooo
  182.           Start _A_r_r_a_y_V_i_e_w in "demo mode".  This causes the actions in AAAAccccttttiiiioooonnnn
  183.           menu to be displayed in a dialog box, but not actually performed.
  184.           If demo mode has been enabled by default (see X Resources, below),
  185.           then _----_nnnn_oooo_dddd_eeee_mmmm_oooo will disable it.
  186.  
  187.      _----_ffff_oooo_rrrr_wwww_aaaa_rrrr_dddd   (or _----_FFFF)
  188.           Indicates that array services requests destined for remote servers
  189.           should be forwarded to those servers via the local array services
  190.           daemon, rather than being sent directly to them.  This is useful
  191.           when array services authentication is in use.  _----_ffff_oooo_rrrr_wwww_aaaa_rrrr_dddd is the
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. aaaavvvviiiieeeewwww((((1111))))                                                              aaaavvvviiiieeeewwww((((1111))))
  203.  
  204.  
  205.  
  206.           default behavior if the value of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD environment
  207.           variable begins with the letter "Y" (as in "yes"; it may be in
  208.           either upper or lower case).
  209.  
  210.      _----_KKKK_llll _k_e_y
  211.           Use _k_e_y for the local authentication key when communicating directly
  212.           with a remote array services daemon.  _k_e_y is an unsigned 64-bit
  213.           value.  The default local key is obtained from the environment
  214.           variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______LLLL_OOOO_CCCC_AAAA_LLLL_KKKK_EEEE_YYYY; if that does not exist, no key is used.
  215.           The actual role played by _k_e_y depends on the authentication method
  216.           used by array services in a particular configuration.  In general,
  217.           it is not used when communicating with an array services daemon on
  218.           the local machine.
  219.  
  220.      _----_KKKK_rrrr _k_e_y
  221.           Use _k_e_y for the remote authentication key when communicating
  222.           directly with a remote array services daemon.  _k_e_y is an unsigned
  223.           64-bit value.  The default remote key is obtained from the
  224.           environment variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______RRRR_EEEE_MMMM_OOOO_TTTT_EEEE_KKKK_EEEE_YYYY; if that does not exist, no
  225.           key is used.  The actual role played by _k_e_y depends on the
  226.           authentication method used by array services in a particular
  227.           configuration.  In general, it is not used when communicating with
  228.           an array services daemon on the local machine.
  229.  
  230.      _----_mmmm_oooo_dddd_eeee _v_i_e_w
  231.           Starts _A_r_r_a_y_V_i_e_w in view _v_i_e_w, which may be "cpuhogs", "processes"
  232.           or "users" (case is not significant).
  233.  
  234.      _----_pppp_aaaa_uuuu_ssss_eeee #_s_e_c_s
  235.           Specifies the PPPPaaaauuuusssseeee bbbbeeeettttwwwweeeeeeeennnn ssssaaaammmmpppplllleeeessss interval (see "Refresh
  236.           Settings").
  237.  
  238.      _----_pppp_oooo_rrrr_tttt _p_o_r_t   (or _----_pppp _p_o_r_t)
  239.           Specifies the port address of the array services daemon.  Defaults
  240.           to the value of the "ARRAYD_PORT" environment variable if present,
  241.           or the standard port number of the "sgi-arrayd" service otherwise.
  242.  
  243.      _----_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh #_s_e_c_s
  244.           Specifies the SSSSccccrrrreeeeeeeennnn rrrreeeeffffrrrreeeesssshhhh interval (see "Refresh Settings").
  245.  
  246.      _----_ssss_aaaa_mmmm_pppp_llll_eeee #_s_e_c_s
  247.           Specifies the CCCCoooolllllllleeeeccccttttiiiioooonnnn ssssaaaammmmpppplllleeee lllleeeennnnggggtttthhhh interval (see "Refresh
  248.           Settings").  _----_ssss_eeee_rrrr_vvvv_eeee_rrrr _s_e_r_v_e_r Specifies the hostname or IP address of
  249.           the array services daemon.  Defaults to the value of the "ARRAYD"
  250.           environment variable if present, or "localhost" otherwise.
  251.  
  252.      _----_ssss_kkkk_iiii_pppp_0000
  253.           Indicates that any process belong to array session 0 (typically
  254.           system processes) should be omitted from the display.  If this
  255.           option has been enabled by default (see "X Resources"), it can be
  256.           disabled with _----_nnnn_oooo_ssss_kkkk_iiii_pppp_0000.
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. aaaavvvviiiieeeewwww((((1111))))                                                              aaaavvvviiiieeeewwww((((1111))))
  269.  
  270.  
  271.  
  272. XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  273.      Many of the options that can be set in dialog boxes or from the command
  274.      line can also be set with X resources.  The class name for _A_r_r_a_y_V_i_e_w is
  275.      AAAAvvvviiiieeeewwww.  Valid resources include:
  276.  
  277.      _aaaa_uuuu_tttt_oooo_RRRR_eeee_ffff_rrrr_eeee_ssss_hhhh (_b_o_o_l_e_a_n, _d_e_f_a_u_l_t _T_R_U_E)
  278.                Specifies the initial setting of the AAAAuuuuttttoooo rrrreeeeffffrrrreeeesssshhhh option.
  279.  
  280.      _dddd_eeee_mmmm_oooo_MMMM_oooo_dddd_eeee (_b_o_o_l_e_a_n, _d_e_f_a_u_l_t _F_A_L_S_E)
  281.                Specifies the default setting of demo mode.
  282.  
  283.      _ffff_oooo_rrrr_wwww_aaaa_rrrr_dddd_RRRR_eeee_qqqq_uuuu_eeee_ssss_tttt_ssss (_b_o_o_l_e_a_n)
  284.                Specifies a default setting for the FFFFoooorrrrwwwwaaaarrrrdddd rrrreeeeqqqquuuueeeessssttttssss vvvviiiiaaaa llllooooccccaaaallll
  285.                sssseeeerrrrvvvveeeerrrr option.  If this resource is not specified, a default
  286.                setting is obtained from the environment variable
  287.                AAAARRRRRRRRAAAAYYYYDDDD____FFFFOOOORRRRWWWWAAAARRRRDDDD.
  288.  
  289.      _ffff_rrrr_eeee_eeee_zzzz_eeee_OOOO_nnnn_SSSS_eeee_llll_eeee_cccc_tttt (_b_o_o_l_e_a_n, _d_e_f_a_u_l_t _T_R_U_E)
  290.                Specifies the default setting of the FFFFrrrreeeeeeeezzzzeeee oooonnnn sssseeeelllleeeecccctttt option.
  291.  
  292.      _llll_oooo_cccc_aaaa_llll_KKKK_eeee_yyyy (_s_t_r_i_n_g)
  293.                Specifies a default local authentication key.  If this resource
  294.                is not specified, a default key is obtained from the
  295.                environment variable AAAARRRRRRRRAAAAYYYYDDDD____LLLLOOOOCCCCAAAALLLLKKKKEEEEYYYY.
  296.  
  297.      _pppp_aaaa_uuuu_ssss_eeee_IIII_nnnn_tttt_eeee_rrrr_vvvv_aaaa_llll (_i_n_t_e_g_e_r)
  298.                Specifies the default PPPPaaaauuuusssseeee bbbbeeeettttwwwweeeeeeeennnn ssssaaaammmmpppplllleeeessss interval.
  299.  
  300.      _pppp_oooo_rrrr_tttt (_i_n_t_e_g_e_r)
  301.                Specifies the default IP port number for the array services
  302.                daemon.  If this resource is not specified, a default port
  303.                number is obtained from the environment variable AAAARRRRRRRRAAAAYYYYDDDD____PPPPOOOORRRRTTTT,
  304.                or the "sgi-arrayd" service.
  305.  
  306.      _rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh_IIII_nnnn_tttt_eeee_rrrr_vvvv_aaaa_llll (_i_n_t_e_g_e_r)
  307.                Specifies the default SSSSccccrrrreeeeeeeennnn rrrreeeeffffrrrreeeesssshhhh interval.
  308.  
  309.      _rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh_OOOO_nnnn_TTTT_hhhh_aaaa_wwww (_b_o_o_l_e_a_n, _d_e_f_a_u_l_t _T_R_U_E)
  310.                Specifies the default setting of the RRRReeeeffffrrrreeeesssshhhh oooonnnn tttthhhhaaaawwww option.
  311.  
  312.      _rrrr_eeee_mmmm_oooo_tttt_eeee_KKKK_eeee_yyyy (_s_t_r_i_n_g)
  313.                Specifies a default remote authentication key.  If this
  314.                resource is not specified, a default key is obtained from the
  315.                environment variable AAAARRRRRRRRAAAAYYYYDDDD____RRRREEEEMMMMOOOOTTTTEEEEKKKKEEEEYYYY.
  316.  
  317.      _ssss_aaaa_mmmm_pppp_llll_eeee_IIII_nnnn_tttt_eeee_rrrr_vvvv_aaaa_llll (_i_n_t_e_g_e_r)
  318.                Specifies the default CCCCoooolllllllleeeeccccttttiiiioooonnnn ssssaaaammmmpppplllleeee lllleeeennnnggggtttthhhh interval.
  319.  
  320.      _ssss_eeee_rrrr_vvvv_eeee_rrrr (_s_t_r_i_n_g)
  321.                Specifies the default hostname for the array services daemon to
  322.                be used for most array services requests.  If this resource is
  323.                not specified, a default hostname is obtained from the
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. aaaavvvviiiieeeewwww((((1111))))                                                              aaaavvvviiiieeeewwww((((1111))))
  335.  
  336.  
  337.  
  338.                environment variable AAAARRRRRRRRAAAAYYYYDDDD.
  339.  
  340.      _ssss_kkkk_iiii_pppp_AAAA_SSSS_HHHH_ZZZZ_eeee_rrrr_oooo (_b_o_o_l_e_a_n, _d_e_f_a_u_l_t _T_R_U_E)
  341.                If true, indicates that any process belong to array session 0
  342.                (typically system processes) should be omitted from the
  343.                display.
  344.  
  345.      _vvvv_iiii_eeee_wwww_MMMM_oooo_dddd_eeee (_s_t_r_i_n_g)
  346.                Specifies the default view mode.  See the ----mmmmooooddddeeee command line
  347.                option for valid values.
  348.  
  349. NNNNOOOOTTTTEEEESSSS
  350.      The array services daemon (_a_r_r_a_y_d(1M)) should be running on all machines
  351.      that are to be monitored.  It does not necessarily have to be running on
  352.      the machine that executes _A_r_r_a_y_V_i_e_w if an alternate server was specified
  353.      in some way.
  354.  
  355. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  356.      arrayd(1M), mpiview(1), arrayd.conf(4).
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.